home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Directorytools / Dux5 / DUX5.doc < prev    next >
Text File  |  1996-09-26  |  23KB  |  463 lines

  1.                        Directory Utility DUX version 4
  2.  
  3. Fixed ARC and DEARC problem.
  4.  
  5. Updated DOCS!!! This will help those having problems with rename and arc/
  6.     DE_ARC.
  7.  
  8. Assign C: to ram: only happens on FORMAT and DISKCOPY and is now reassigned
  9.   to sys:c after the function completes.
  10.  
  11. Typing into any string gadget with a <CR> does not try to get the new
  12. directory.
  13.  
  14. SLIDING WINDOWS! -- CLICK on the sliders and whold them down and move them 
  15. arround. The files update as you slide.
  16.  
  17.                        Directory Utility DUX version 3
  18.  
  19. This program now allows multiple directory selection.
  20.  
  21. NOTE: For this program to work the commands Execute and Assign
  22.       must be in the sys:c directory.
  23.  
  24.  
  25.                        Directory Utility DUX version 2
  26.  
  27. Questions or comments can be placed on PLINK to OPS602. I would be
  28. interested in any future improvements people would like to see.
  29.  
  30. NOTE: a final bug in the update of both the source and destination
  31. directories has been fixed. To DLDSET delete a directory or DELETE 
  32. a program or to FORMAT or DISKCOPY a DISK you must click the 
  33. gadget twice!
  34.  
  35. This is an upgrade of the program I have been modifying.
  36. The following comands and directories are needed for the Diskcopy
  37. and format functions to work:
  38. DIRECTORY        C            LIBS             SYSTEM
  39. PROGRAM NAME    Assign       icon.library      Format
  40.                 Run                            Diskcopy
  41.  
  42. All commands in any of the directories must start with CAP and the
  43. rest of the name should be lower case. This is true for any command
  44. you want selected to ram:
  45.  
  46.                  
  47.  The following features have been added:
  48.  
  49. 1. COMMAND SELECTION TO RAM: The Gadgets DLDSET and GTDSEL
  50. are  multifunction gadgets.  When DUX first comes up the two
  51. directories on the screen are the default C directory and the DUC
  52. directory utility C directory.these gadgets are used to select
  53. and set the comands you wish to place in ram:. Also a message
  54. displayed requesting comamand selection is displayed on startup.
  55. The GTDSEL gadget can be poked to highlight all commands 
  56. DU would currently need. This you can use if you have memory to
  57. burn. Or you can select a single command just as you select a file
  58. THen by using the COPY gadget you can copy your selected commands
  59. to the DUC directory in ram:. This is the Directory utility Command
  60. file in ram:.
  61. Then use the gadget DLDSET to set the commands to the ram:
  62. directory. Once this gadget is poked the GTDSEL and DLDSET keys
  63. then become the function GET DIRECTORY and DELETE DIRECTORY.
  64. Th following gadgets can be poked durring the selection process:
  65.      ALL,CLEAR,GTDSEL,COPY,the slide bars and file selection windows.
  66. Any other action will leave all commands on the default directory
  67.  and the GTDSEL and DLDSET gadgets will no longer function as 
  68. command selection gadgets.
  69.  
  70.  
  71.            D I R U T I L  X X  - file/disk utility program 01/02/87
  72.            UPDATED BY DEAN D. HELD   Minneapolis, MN
  73.  
  74. TWO DIRECTORIES IN TWO WINDOWS. This program now has 2! directory windows
  75. which prevents so much disk activity when switching directories. The highlighted
  76. window is the source the un highlighted window is the destination. 
  77. TO select the source window click on the slide gadget, the corect file 
  78. selection window, or use SWAP which now switches the highlight.
  79. Also GLOBAL RENAME,EXECUTE,DISKCOPY,MOVE WITH DELETE
  80. (same as COPY but deletes the source files after copy),DEARC,ARC,ARCLIST
  81. (now goes to unhighlighted destinaton device).
  82.  
  83.  
  84.  
  85.  
  86.           D I R U T I L   I I I   - a file/disk utility program
  87.                 Original Version by Chris Nicotra
  88.                 Revisions/Enhancements/Fixes by Dave Jobusch,
  89.                 Rich Medved and Nathan Barber 
  90.  
  91.  
  92.    A feature that I really like is being able to get a screen 
  93. display of ASCII files from programs like "Sweep".  The only 
  94. version of DirUtil that has ever had this lacked the numerous 
  95. gadget buttons of this version.  Unfortunately, on that version, 
  96. the individual that added the TYPE feature, decided to keep the 
  97. code.  It's a pity, he had a good implimentation.  When I found this 
  98. version on a local board,  there were only two things that I didn't like. 
  99. The lack of a TYPE was one.  The other is that I have three floppies on my 
  100. Amiga, but the utility only had gadgets for df0: and df1:.  Well, now it 
  101. supports df2:.  When I compiled the code, I got over 50 compiler warnings, 
  102. I cleaned up over half of them and, hopefully, didn't add any new ones. 
  103. Don't worry about the warnings, the code compiles and links fine -- it's 
  104. just that I got tired of looking for errors in midst of the field of 
  105. warnings. It compiled fine with Lattice 3.03 and Manx 3.2
  106.  
  107.         This program is in the public domain. That means you can't
  108.         sell the damn thing to anyone, and further more, I doubt
  109.         you'd get much for it. As a matter of fact, I beat this
  110.         thing to death for 2 weeks, and it still isn't perfect,
  111.         but it works. I got the original program from a BBS 
  112.         in Omaha, and do not know who Chris Nicotra is.
  113.  
  114.         Instructions:
  115.         Click on file or directory names in the file window to 
  116.         select a file to take action on. Click on one of the
  117.         many gadgets to take the selected action on the selected
  118.         files/directory (yes, only one directory at a time).
  119.         The three string gadgets at the bottom are:
  120.  
  121.                    First directory. This can be the source or destination
  122.                    based on being highlighted or unhighlighted.
  123.  
  124.                    Second directory. This can be the source or destination
  125.                    based on being highlighted or unhighlighted.
  126.  
  127.                 E: The string to be passed:
  128.                          GRENAM  -- input to gadget as described.
  129.                          FORMAT  -- name of disk to be formated.
  130.                          RUN     -- parameters to be passed to program being
  131.                                    run.
  132.                          EXECUTE -- parameters to pass to the file
  133.                                    being executed. 
  134.  
  135. df0:,df1:,df2:,df3:,ram:,hd0:,hd1:,hd2: --->
  136.             
  137.                 Set current directory to the root of the selected device.
  138. ALL --->
  139.                 Select ALL files in the current highlighted source 
  140.                 directory, including the ones "scrolled off" the window.
  141.  
  142. ALLDIRS --->
  143.                 Highlights all directories.
  144.  
  145. ALLWIND --->
  146.                 Highlights all files in the highlighted source window 
  147.                 (9 at a time). This is handy for arciving a directory 
  148.                 that is two large for a 3 1/2" disk.
  149.  
  150. ARC     --->    Select all Files to be Archived in the source window 
  151.                 (highlighted), Enter the name of the new Archive in 
  152.                 the Destination box (not highlighted). Then Select 
  153.                 ARC. For fast arcing,copy all files to be arced into ram:
  154.                 Archive name does'nt need anything before it,but you can 
  155.                 use one in the following format:.  In the destination
  156.                 unhighlighted window enter the name of the arc file.
  157.                 If the destination is ram: then the ARC file name
  158.                 would be ram:ARCFILE.ARC.
  159.                 If the destination is ram:DIR1 then the ARC file name
  160.                 would be ram:DIR1/ARCFILE.ARC.
  161.                 no name the file will be created as .ARC.
  162.  
  163. ARCLST  --->    This lists all files in the selected ARC files in the 
  164.                 highlighted source window.
  165. BYTE --->
  166.                 Adds up the number of bytes of the selected files in the 
  167.                 highlighted source directory and displays the sum and 
  168.                 the number of files.  Remember that each file takes up 
  169.                 512 more bytes than indicated because of its directory entry.  
  170. CLEAR --->
  171.                 De-select all selected files in the highlighted source 
  172.                 directory.
  173.  
  174. CLRDIRS --->
  175.                 Clears all selected directories in the highlighted source
  176.                 directory.
  177.  
  178. CLRWIND --->
  179.                 Clears all files in the highlighted source window.
  180.  
  181. COPY --->
  182.                 Copy selected files to the directory specified in the
  183.                 unhighlighted destination string gadget. It must be
  184.                 an existing directory path and CAN go across devices.
  185.                 You should be able to enter paths relative to the 
  186.                 current directory.
  187.  
  188. CPYDIRS --->
  189.                 Copies multiple selected directories in the highlighted
  190.                 source directory to the unhighlighted destination
  191.                 directory.
  192.  
  193. DE-ARC  --->    Select one or more Arced files,then select DE-ARC.Enter 
  194.                 the device name +#? (DF1:#?) or (DF1:DIR1/#?) in the 
  195.                 destination unhighlighted window. The files will be 
  196.                 un arced and placed on the destination device and directory.
  197.                 See GRENAM for a clearer description. This also works in ram:
  198.                 WARNING!!! if the file being DE_ARCED is already
  199.                 in the destination directory DUX and all previous
  200.                 versions get hung up. I do not know how to fix this.
  201.                 PEOPLE REALLY SHOULD NAME THEIR README FILES AS ex.
  202.                 DUX4.doc. I REALLY HATE when I DEARC a set of FILES
  203.                 and all my README files get over writen because they
  204.                 WERE all called README. 
  205.  
  206. DELDIRS --->
  207.                 Deletes selected directories in the highlighted 
  208.                 Source directory.
  209.  
  210. DLDSET --->
  211.                 On startup this will set the commands selected as in ram:
  212.                 or disk.  This command looks at the ram:DUC directory and
  213.                 if the command is located in ram: it assigns the command
  214.                 to ram: other wise it gets the command from the sys:C
  215.                 directory. Once the commands are set in ram: then this
  216.                 gadget becomes the delete directory command described as
  217.                 follows:
  218.                 This will delete the non-empty diretory that you have
  219.                 selected in the file window. You will get and error
  220.                 if the directory is not empty.
  221.  
  222. DELETE --->
  223.                 Delete selected files in the Highlighted source directory.
  224.                 This will not delete directories.
  225. DINFO --->         
  226.                 Used to show the number of USABLE bytes from the DEVICE 
  227.                 associated with the unhighlighted destination directory.
  228.  
  229. DSKCPY --->
  230.                 Disk copy now runs a program to disk copy disks. 
  231.                 Any prgram named diskcopy in the C directory will work.
  232.                 Even the amiga disk copy program. This copies the device
  233.                 in the highlighted source window to the device in the 
  234.                 unhighlighted destination window. FIRST CLICK THE DISK
  235.                 COPY GADGET ONCE. INSERT SOURCE AND TARGET DISKS AS
  236.                 SPECIFIED. CLICK THIS GADGET AGAIN. THE DISKS WILL BE COPIED.
  237.                 BEFORE DOING ANY OTHER FUNCTION INSERT YOUR WB DISK BACK IN.
  238.                 ON YOUR NEXT COMAND ACTION C: WILL BE ASSIGNED FROM RAM:
  239.                 BACK TO SYS:C.
  240.  
  241. SCRIPT --->     
  242.                 This function is used to play AGIES script files. 
  243.                 the command must be in the default C directory as 
  244.                 "Player". This function will play the highlighted 
  245.                 script files in the source window.
  246. EDIT --->
  247.                 EDIT allows you to use a text editor from within
  248.                 DirUtil.  First click on the file you want to
  249.                 edit, then click on the EDIT gadget.  To enable this
  250.                 feature, you must rename your text editor to "E"
  251.                 and place it in the SYS:c directory.
  252.                   
  253. EXECUTE --->    Now executes an execute file selected in the highlighted
  254.                 source window and passes the parameters from the E window.
  255.  
  256. GTDSEL --->     On startup you can select this gadget first to
  257.                 highlight all the commands used by DUX then
  258.                 select the copy gadget to copy the commands to ram:
  259.                 and then clikc the DLDSET to set the commands in ram:
  260.                 from then on all commands are executed from ram:
  261.                 and this icon defalts to the GETDIR function.
  262.                 You can also select all or click on one or any
  263.                 of the commands and only copy your preferance of
  264.                 commands to ram: for greater versitility.
  265.                 IMPORTANT!!!!!
  266.                     All commands must be CAPS first and then
  267.                     small letters ex. Player,Show,E,Diskcopy...
  268.                     except... NewCLI, EndCLI.
  269.  
  270.                 If you want to go to a new directory, select
  271.                 a directory in the highlighted source window, 
  272.                 and click on this gadget. 
  273.  
  274. FORMAT --->     Format a disk. this feature formats a disk. 
  275.                 The format comand formats the highlighted 
  276.                 source window device selected and names the disk
  277.                 with the file name in the execute "E" window.
  278.  
  279. GRENAM --->     This is my pride and joy! A global rename. 
  280.                 Comands are entered in the execute window with the 
  281.                 following format.
  282.  
  283.         +]abcd   adds the characters 'abcd' to the front of all highlighted 
  284.                  files.
  285.  
  286.         +[.pic   Adds the characters '.pic' to the back of all highlighted
  287.                  files 
  288.  
  289.         -]3      Removes 3 characters from the front of all highlighted
  290.                  files.
  291.         -[3      Removes 3 characters from the back of all highlighted
  292.                  files.
  293.         
  294.         #?abcd>efgh
  295.                 This searches all files highlighted for the string 'abcd'
  296.                 and replaces the string with the string 'efgh'!
  297.                      fileabcd.pic -> fileefgh.pic
  298. HTYPE --->
  299.                 Types a file to the screen in HEX and ASCII 16 numbers
  300.                 at a time.
  301. MAKDIR --->
  302.                 This will create the directory that you have typed in
  303.                 the highlighted source window gadget. You MAY use 
  304.                 relative paths.
  305.                 ex:  click on the highlited string gadget and enter the
  306.                      following:
  307.                         ram:     ---> ram:newdirectoryname
  308.                         ram:DIR1 ---> ram:DIR1/newdirectoryname
  309.                 then click the gadget. The new directory will be made
  310.                 and the current directory will be returned to:
  311.                         ram:      or      ram:DIR1 respectively.
  312.                 The directory will be created in the highlighted source
  313.                 window.
  314. MOVE --->
  315.                 Same basic principle as RENAME, but assumes that you
  316.                 want to just move the file to a new directory, not
  317.                 actually rename it.  It will move multiple files from
  318.                 one directory to another.  
  319.  
  320. MOVDEL --->     This is like a rename between devices. What it does is 
  321.                 move files from the highlighted source window to the
  322.                 unhighlighted destination window from one device to 
  323.                 another and then deletes the source files.
  324.  
  325. NEWCLI--->       bring up a new CLI.
  326.  
  327. FILENOTE --->   Place a filenote on the specified source file. This
  328.                 feature takes the specified source file and addes a 
  329.                 filenote to it. This feature does only one file at a time.
  330.  
  331. PARENT --->
  332.                 Go to the parent directory in the highlighted source
  333.                 window
  334. PRINT --->
  335.                 Same as TYPE, but the output goes to PRT:
  336. RENAME --->
  337.                 Renames first selected file or directory to the name
  338.                 or path specified in the highlighted source directory.
  339.                 ex:  click on the highlited string gadget and enter the
  340.                      following:
  341.                         ram:     ---> ram:newdirectoryname
  342.                         ram:DIR1 ---> ram:DIR1/newdirectoryname
  343.                 then click the gadget. The new directory will be made
  344.                 and the current directory will be returned to:
  345.                         ram:      or      ram:DIR1 respectively.
  346.                 The directory will be created in the highlighted source
  347.                 window.
  348.                 
  349. ROOT --->
  350.                 Go to the root of the current device in the highlighted
  351.                 source window.
  352. RUN ---> 
  353.                 "RUNS" the selected files from inside DIRUTIL. If DIRUTIL
  354.                 was called from CLI, any output from the program is
  355.                 directed to the calling CLI.  Parameters may be passed
  356.                 to the program by entering them in the E window.
  357. SEARCH --->
  358.                 Searchs the marked group of files for the pattern found
  359.                 in the E window.  Upper/lower ARE different. If the \
  360.                 character is found, the next two characters are converted
  361.                 into a single Hexadecimal digit and used as one
  362.                 character in the overall search.  The search pattern was
  363.                 limited to 60 max characters by choice.  The search has
  364.                 two modes, SLOW and FAST, which it will choose depending
  365.                 on how much memory is available in the machine. I HIGHLY
  366.                 recommend freeing up enough RAM to allow the FAST mode to
  367.                 run since the SLOW mode is AT LEAST 10 times slower.
  368.                 The SLOW mode search can be aborted by hitting the ESC
  369.                 key. The FAST mode cannot be aborted, it is so fast you
  370.                 will not mind the slight wait.
  371. SHOW --->       
  372.                 The show comand must be in the C directory as Show.
  373.                 Select the IFF files you wish to display, one or more,
  374.                 then click on the SHOW gadget.  DirUtil will attempt to
  375.                 display these files.  This function will work with most,
  376.                 but not all forms of IFF files.  If DirUtil can not 
  377.                 display the file, an error message will be displayed in
  378.                 the error msg. window and DirUtil will go on to the next
  379.                 selection, if there is one.
  380.  
  381.                 DirUtil opens a new screen for the IFF file, displays the
  382.                 file, then waits for you to continue.  When finished
  383.                 viewing the image, click in the upper-left corner of the 
  384.                 image.  There is an invisible close gadget located there.
  385.                 DirUtil will close the screen and procede to display 
  386.                 the next file.
  387.  
  388. SINFO --->
  389.                 Used to show the number of USABLE bytes from the DEVICE 
  390.                 associated with the highlighted source directory.
  391. SWAP --->
  392.                 Used to flip the Source highlight from one widow
  393.                 directory to the other.
  394. TYPE --->
  395.                 Use this to view standard ASCII (readme, docs, etc) on
  396.                 stdout; usually your CRT.  Select the files you want to
  397.                 view, then select the TYPE gadget.  A new window, with 
  398.                 the window name being the file that you are currently
  399.                 viewing, will open.  Use the space bar to advance by one
  400.                 screen, a <CR> will advance one line.  Entering ESC will
  401.                 advance you to the end of that file.  The space bar will
  402.                 then exit from that file.  If you have selected to view
  403.                 more than one file, the next will automatically be
  404.                 displayed.  After all selected files have been viewed,
  405.                 the window will close, returning you to DirUtil's main
  406.                 screen.
  407.  
  408.  
  409.         
  410.         NEW NOTES: 6-Aug
  411.                 Because of a problem with locking and unlocking the
  412.                 current directory on a disk that had been removed,
  413.                 I had to make a change to what the program defaulted
  414.                 to (for a current directory).
  415.                 Changes made:
  416.                         - Initial current directory is ALWAYS set to RAM: 
  417.                         - if you really confuse it, it will go to RAM:
  418.                           rather than SYS:
  419.  
  420.                 I forgots :
  421.                         I neglected to mention a rather important feature.
  422.                         If you did something stupid like select all files
  423.                         and then hit delete, and suddenly realize that
  424.                         you REALLY didnt want to do that, there is a
  425.                         STOP IDIOT feature. When you are doing operations
  426.                         on a group of files, CLICKING ANYWHERE IN THE
  427.                         WINDOW WILL ABORT THE OPERATION.
  428.  
  429.  
  430.                  This program is "HackerWare", a program that contains executable,
  431.         source, icon, and docs.  PLEASE keep all the files intact 
  432.         
  433.         Here's a scenerio that results in a BIG bug that bit me squarely
  434.         in the butt after 4 hours of work!
  435.  
  436.         rename duIII.c duIII.c/duIII.c
  437.  
  438.         Yes, that means rename duIII.c to duIII.c in the subdirectory 
  439.         called duIII.c.  I know that that is not supposed to happen and
  440.         should fail, BUT, because of one time string concat. bug in Dirutil,
  441.  it did happen with TERRIBLE consequences. If the files involved were
  442.         in the RAM: disk, the ORIGINAL file is DELETED and the memory is
  443.         NOT deallocated, effectively crippling the machine and any work
  444.         you had done to that file.  If the file was on a floppy, it still
  445.         deletes the file and does not tell the DOS to free up the space,
  446.         effectively locking out mucho space on your disk and having God
  447.         only knows what other consequences later on down the road.  I
  448.         sure wish C-A would get it right in the future and I hope someone
  449.         with closer contacts to the "Gurus" will inform them of this
  450.         "oversight"! 
  451.  
  452.         For anyone interested, it takes the 68000 158+ cycles to do a
  453.         division and 70+ cycles to do a multiply. By changing all 
  454.         the division and multiplication in a program to >> and <<
  455.         shifts, you can save 150 cycles per instruction! (assuming you are
  456.         dividing by a base 2 number). I did this to the quicksort loops
  457.         and it helps greatly.
  458.         Mini-Doc for DirUtil IV vers 2. for utilities made by Greg Cunningham.
  459.  
  460.  
  461. Output Window - Used by Programs EXECed,and by Arc GRENAM
  462.                 and Show. It can also be used by you as notepad.
  463.